home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Mail / pine3.92 / contrib / vms / readme.vms < prev    next >
Text File  |  1994-08-08  |  4KB  |  103 lines
  1.                     VMS readme for PINE/C-CLEINT/PICO
  2.                          ========================
  3.  
  4. Building
  5. ========
  6.  
  7.   There are three executables:
  8. Pico/PICO.EXE: This is the stand-alone version of the editor.
  9. C-Client/MTEST: Testing program for debugging purposes.
  10. Pine/PINE: The pine...
  11.  
  12. In order to build SET DEF into the top directory (i.e. the one above PINE.DIR,
  13. PICO.DIR, etc.) and then @VMSBUILD. It will rename the C-CLient directory and
  14. then compile Pico, C-Client and Pine.
  15.  
  16. Optional parameters to the VMSBUILD command:
  17.  
  18. NETLIB - Use the Netlib library. It must be preloaded into [.NETLIB]NETLIB.OLB
  19. MULTINET - Call Multinet's transport directly.
  20.  
  21. If more than one option is used - separate them with coma and no spaces.
  22.  
  23. There are a few warnnings during the link - ignore them...
  24. On VAX we have to link the objects themselves and can't use libraries since the
  25. linker/librarian lose the global variables; on AXP it is ok...
  26.  
  27.  
  28. Using
  29. =====
  30.   All the user needs is the PINE.EXE; Pine reads the mail from the user's
  31. VMS/MAIL files and send outgoing mail either via mail routines using some
  32. foreign protocol or via direct SMTP to some SMTP server (I preffer this
  33. metod). You use the latter by defining SMTP-SERVER field with some host.
  34. If you do not set it you must define PINE_MAIL_PROTOCOL to the prefix of
  35. the foreign protocol used. For example, if you use SMTP% you have to define
  36. it to SMTP.
  37.   The global PINE configuration file (if needed) is located at UTIL$:PINE.CONF;
  38. if you want to recompile it with a different name then modify PINE/OS.H;
  39.  
  40.  
  41. Why TcpIp communication is needed?
  42. ==================================
  43.   It is not really needed, but helps much. It is needed in three places:
  44. 1. Sending mail: You can either send mail using the xxx% mechanism by defning
  45.    PINE_MAIL_PROTOCOL; in this case no TcpIp is needed.
  46.    you can use another mechanism: Don't define the above but set some SMTP
  47.    server node name in PINE.CONF or .PINERC. In this case you need some
  48.    SMTP package.
  49. 2. PINE can read NEWS via the NNTP protocol which runs over TcpIp...
  50. 3. Remote nodes (usually PC) can access the IMAP daemon and PINE can access
  51.    remote IMAP servers using TcpIp.
  52.  
  53.  
  54. Restrictions
  55. ============
  56. 1. In order to not modify the source too much the handling of the special
  57.    INBOX folder was not modified. Hence, it always try to open the (empty)
  58.    INBOX folder instead of NEWMAIL.
  59.    It is possible to define in the system's wide PINE.CONF that
  60.    inbox-path=NEWMAIL. In this case NEWMAIL will be opened when PINE is
  61.    started. However, the user must not then switch to another folder as long
  62.    as NEWMAIL has items.
  63. 2. WASTEBASKET folder is not used.
  64. 3. .PINERC and .ADDRBOOK are fixed to the user's login directory and cannot
  65.    be defined to be elsewhere (the definition is ignored).
  66. 4-100. Probably exists and I forgot to mention :-)
  67.  
  68.  
  69. IMAPD
  70. =====
  71.   IMAPD of version 3.89 is available with the old Pine VMS port from
  72. VMS.HUJI.AC.IL; the current version of IMAPD will be ported soon.
  73.  
  74.  
  75. NETLIB
  76. ======
  77.   NETLIB can be obtained from PUBLIC.TGV.COM:/MADISON/NETLIB. NETLIB supports
  78. all the common TcpIp packages like Multinet, UCX, Fusion, Wollongong, etc.
  79.  
  80.  
  81. Suggested PINE.CONF file.
  82. =========================
  83. here is the PINE.CONF file we use here:
  84.  
  85. # Our fully-qualified machine name:
  86. user-domain=vms.huji.ac.il
  87.  
  88. # Where to connect to send outputgoing mail.
  89. smtp-server=vms.huji.ac.il
  90.  
  91. # Which viewer to see GIF/JPEG/etc.
  92. image-viewer=xv
  93.  
  94. # Which folder will be opened automatically when entering PINE. See note above.
  95. inbox-path=NEWMAIL
  96.  
  97.  
  98. Notes:
  99. =====
  100. 1. Due to the readonly definition in the source files we use an external
  101.    #define to redefine it to something else. Due to that CTYPE.H fails, so
  102.    we use a private copy of it.
  103.